package com.study.map.service;

import com.study.map.dto.WeatherRequest;
import com.study.map.dto.WeatherResponse;
import com.study.map.exception.MapServiceException;

/**
 * 天气查询服务接口
 *
 * @author study
 * @date 2025-08-31
 */
public interface IWeatherService {

    /**
     * 天气查询：根据城市查询天气信息
     *
     * @param request 天气查询请求参数
     * @return 天气查询结果
     * @throws MapServiceException 地图服务异常
     */
    WeatherResponse weather(WeatherRequest request) throws MapServiceException;

    /**
     * 天气查询：根据城市查询天气信息
     *
     * @param city 城市名称或区域编码
     * @return 天气查询结果
     * @throws MapServiceException 地图服务异常
     */
    WeatherResponse weather(String city, Integer weatherType) throws MapServiceException;
}